例如，创建一个图像 (Image) 节点并将其命名为 PanNode。
当您启用属性时，用户能选取节点。
默认情况下，按钮 (Button)、列表框项容器 (List Box Item Container)、滚动视图 (Scroll View) 和 滑块 (Slider) 节点启用命中测试。 请参阅定义哪个节点接收用户输入。
Kanzi Studio 会创建一个别名（它指向您从中创建该别名的节点），并将该别名添加到它的含资源字典的最近祖先节点的资源字典中。
使用
# 符号后跟别名名称访问别名目标节点。
Kanzi Studio 从 Kanzi Studio 工程创建 kzb 文件和配置文件。Kanzi Studio 将导出的文件存储在 <ProjectName>/Application/bin 目录或您在 > 的二进制导出目录 (Binary Export Directory) 属性中指定的位置。Kzb 文件包含 Kanzi Studio 工程中的所有节点和资源，您在本地化表中标记为本地化包的资源除外。
当您从 Visual Studio 中运行您的 Kanzi 应用程序时，您的应用程序就会加载 kzb 文件和配置文件。
- 为平移消息定义处理程序。
例如，在实现应用程序逻辑的类的 public 部分后添加：private: // 为PanManipulator::StartedMessage消息定义处理程序，该消息来自 //具有可生成平移消息的输入操纵器的 2D 节点。 //此处理程序可为平移手势准备 2D 节点。 void onPanStarted(PanManipulator::StartedMessageArguments& messageArguments) { //从消息参数获得用户平移的节点。 Node2DSharedPtr node2d = dynamic_pointer_cast<Node2D>(messageArguments.getSource()); if (!node2d) { return; } //当开始节点上的平移手势，让节点位于前面。 node2d->moveToFront(); } //为PanManipulator::MovedMessage消息定义处理程序，该消息来自 //具有可生成平移消息的输入操纵器的 2D 节点。 //此处理程序按平移手势的量变换 2D 节点。 void onPanMoved(PanManipulator::MovedMessageArguments& messageArguments) { //从消息参数获得用户平移的节点。 Node2DSharedPtr node2d = dynamic_pointer_cast<Node2D>(messageArguments.getSource()); if (!node2d) { return; } //获得自平移手势序列中上一条消息以来 //平移的像素距离。 Vector2 translationDelta = messageArguments.getDelta(); //获得节点的渲染变换 (Render Transformation) 属性。 SRTValue2D nodeTransform = node2d->getRenderTransformation(); //获得节点的大小。 Vector2 nodeSize = node2d->getActualSize(); //获得节点的当前变换。 Vector2 translation = nodeTransform.getTranslation(); //从平移消息应用变换。 Vector2 translationTarget = translation - translationDelta; //设置新变换。 nodeTransform.setTranslation(translationTarget); //应用新变换到节点。 node2d->setRenderTransformation(nodeTransform); } - 在
onProjectLoaded()函数中创建PanManipulator操纵器并订阅其消息。
例如，添加：virtual void onProjectLoaded() KZ_OVERRIDE { ScreenSharedPtr screen = getScreen(); Domain* domain = getDomain(); //使用别名获取PanNode。 NodeSharedPtr panNode = screen->lookupNode<Node>("#PanNode"); //创建生成平移消息的输入操纵器。 PanManipulatorSharedPtr panManipulator = PanManipulator::create(domain); //设置水平和垂直轴的阈值（以像素为单位）， //在输入操纵器识别平移手势之前，手指或鼠标需要移动轴。 panManipulator->setRecognitionThreshold(Vector2(10.0f, 10.0f)); //添加输入操纵器到PanNode。 panNode->addInputManipulator(panManipulator); //订阅PanNode 的PanManipulator::StartedMessage消息。 //PanManipulator在用户点击或触摸附加节点时生成此消息。 panNode->addMessageHandler(PanManipulator::StartedMessage, bind(&MyProject::onPanStarted, this, placeholders::_1)); //订阅 PanNode 的PanManipulator::MovedMessage消息。 //当用户在水平或垂直轴上移动手指或鼠标超过识别阈值时，PanManipulator//首次生成此消息，然后 //当手指或鼠标在更新之间移动时生成此消息。 panNode->addMessageHandler(PanManipulator::MovedMessage, bind(&MyProject::onPanMoved, this, placeholders::_1)); }
在应用程序中点击并拖动或轻敲并拖动已启用平移手势的节点。
